¥ f π f m f ú f ; f < Ÿ f f Ë NH ∂ NH Δ NH Œ NH ‚ NH – f ® Ÿ ¯ Ÿ ° Ÿ É ¿ Ÿ € O ¿ I \ Ÿ f ⁄ Ÿ ¶ € " f ñ ñ ñ í ñ 8 ñ M f N f l f m ‡ n ‡ Δ f € f ¥ \ œ \ fl \ L à « Û ¬ Û ¿ à ! à !p à "h f # f #K f $ f $◊ Ÿ $Ø ´ $î f %´ \ &£ f &€ f '3 Ñ '; f '< f (é f )h f )i Ü )| â )π â )fl ë * Ì ˇ µ
¨ à ¡ 5 à ^
Ï t
à R ¬
Ï
∏ Ó – ,
À -
Ï ‘
Ï π
Ï Î
ç à
Ï ø
ú b
Ï ı
Ç w ª z
Ç Ï ƒ fi
Ë ß
Ç ù
»
Ç !
 q
Æ s
 ‰ à ï ±
 Ë
s
’
Â
3
s
∫
Â
Ω
s
é
’
û
s π
 Ï
’ ä
s z
 §
s ú
Â
e
’
v
s ; Õ Î < à ï e
Å f
 ≤
s Ë
Ê õ Õ
Ê
Õ
Ê 6 Õ L
Ê g
Ê l
Ê ˘ Õ ¨
Ê ï ß ‡
Ê Õ Œ
Ê ® ß ∏
Ê ¢ ã °
Ê »
- Ö
è ◊
Ê Q Õ V
Ê k Õ œ á ¬ Õ – Õ Î ® à ï È
Å É
Ò +
Ò • Ó ∑
Ò Ÿ
ä O
Ò I
º J ¯ Ÿ
 ⁄ à ï µ Õ û ¶
ä º
æ ◊
ä
ä
ä " V Œ ù V ø 8 î ] › u î › — î ƒ ø : ø V m ø Ω ¢ ø Ù ø ø 7 ø M fl N
s l
 m à ÿ ∂ Δ
s € V ¥ í œ ¯ º í 1 ¯ : í L ê M
à B S
ó « à fi ≤ å ¿
ó !´ 9 !Ç
ó !É 9 !Í
ó !ç 9 !‡
ó "A
« "_
ó "h
 "ˇ V "«
 # V #J
 #w V #∑
 # #é V #ÿ
 $
à Ú $
 $I
” $d
 $Ö $◊ Õ Δ $Ø à · $î
 $ò V %
 %“ %´ ¯ &£
π &€
à Ú &ª
 '2
π '3 Ó j ': † ';
 (ç (é
 )i à ü ){ ì )| ˛ )~
ı )π ˛ )≤
Ô )Í
à )õ
Ô )‡
ò )fl à ± *
ö *
z *
¬ *,
£ *.
ô ´ îPµ´ î~P¶´ l‹P¶° <}Pµp ’±PµT jQPµX »†Pµl ˘ùPµP Œ∏QÏÄ N QÏ° m7N†¨ €zPµH ¡P¶‰ !¿úP¶ì $’ P’≥ $Ö Pµt $◊âPµô '’P¶¬ î
›
T E C H N O T E :
Power Management & Servers:
Auto Restart From Power Failure
By Vinnie Moscaritolo
<http://webstuff.apple.com/~vinnie/>
Apple Developer Technical Support (DTS)
Automatically restarting from a power failure is an important feature for any server. Normally, powering up a Macintosh computer requires manual intervention by the user. It is possible, however, to configure the Macintosh hardware, so that the system will power itself up anytime primary A.C. is available.
This Note discusses how to communicate with the MacintoshÕs internal power management microcontroller and is important for developers who design software that must run in an environment where little or no human intervention i ~s available.
The Process of Turning On Your Macintosh
Most server software is designed to run in an environment where youÕre not guaranteed human supervision. A remote server, for example, ought to be able to restart itself after a power failure without any manual interaction.
By default, Macintosh computers are designed to be used in a desktop environment, where the user must power up by manually pressing the power-on key. However, in most cases it is possible to configure the Macintosh firmware, so that the system will power itself up the next time that primary A.C. is available.
Most Macintosh computers are equipped ‹ with an internal microcontroller that, among other things, manages the Macintosh power providing Soft Power Control. This microcontroller, a custom ASIC designed specifically for Apple, dictates the circumstances under which the Macintosh will initiate a power up cycle. Typical power-on options include:
Manual depression of the Power-key on the keyboard.
Manual depression of a momentary contact switch, usually mounted on the rear chassis of the system.
External power up, such as occurs when a NuBus card asserts the PFW signal directly.
The internal power up alarm specified by the Power Manager command SetStartupTimer becomes active.
On Macintosh units that support this feature, there is a Wakeup line connecte }d to the serial ports GPI pin. A typical application of this feature is to power up the Macintosh when it is used as an answering machine or modem server.
When the system is configured in Server Mode and A.C. power is restored.
This Note only concentrates on the last two options, Server Mode and Wakeup Mode, and how to enable/disable them.
Introducing The Cuda Manager
Server Mode is enabled by accessing an internal piece of Macintosh system software known as the Cuda Manager (also known as Egret). The Cuda is the firmware that communicates to the microcontroller responsible for managing the Macintosh power.
Keep in mind that not all Macintosh models have the Cuda Manager or Soft Power Control. Soft Power Control exists only on systems where A.C. voltage is always available to the power supply, and the power supply is controlled by the state of the power fail warning (PFW) signal ±.
On the other hand, Passive Power Control exists in systems where the power supply is turned off or on by a switch directly in line with the primary A.C. voltage to the supply.
For example, Macintosh Classic and Macintosh II LC employ Passive power control, while the Macintosh II and most Power Macs use Soft Power.
There are also certain Macintosh models, such as the Color Classic and LC475, LC575 CPUs, that implement a Pseudo Soft Power supply control. In those cases, the keyboard power key can be used to initiate a power up of the system, but the chassis switch is wired directly to the power supply and is not utilized by Cuda.
Determining If Your Mac Supports the Cuda
The Qproper way to determine if a particular Macintosh model supports the Cuda Manager is as follows:
Use the Gestalt function to check for the gestaltHardwareAttr 'hdwr' selector. Then check the response for gestaltHasSoftPowerOff (bit 19). This will indicate if the Macintosh supports Soft Power
Use the GetOSTrapAddress to check for the existence of the Cuda Manager dispatch trap known as _EgretDispatch ( $A092 )
In addition to checking the _EgretDispatch trap vector, you also need to ensure that the Cuda Manager software is loaded. There are a few Macintosh ROMs that, even though they implement the Cuda trap, do not have appropriate Cuda hardware. On these machines, invoking the _EgretDispatch trap call †will result in a bus error.
In order to verify that the Cuda software was loaded, you need to check that the internal low memory global at location 0xDE0 does not equal -1.
Only after you have established the existence of the Cuda Manager should you then pass commands to it. You can do this by issuing a trap dispatch call to the Cuda Manager through the $A092 trap.
On entry, r ùegister A0 must contain a pointer to a parameter block which describes the type of function to be executed by Cuda and how a response to execution of that function is to be returned.
When issuing a Cuda dispatch trap from C, it is necessary to pass a pointer to the Cuda parameter block to the trap using register A0 as a pointer to the parameter block. The following function prototype can be used to interface to the Cuda Manager:
#pragma parameter Cuda( __A0 )
void Cuda( CudaPB* myPB ) = 0xA092;
Cuda Manager Parameter Block Structure
The Cuda Manager parameter block structure used by all the Cuda Management functions is defined as follows:
#define pseudoPkt 0x01 /* Cuda Pseudo Packet */
#define EnDisFileS 0x13 /* enable/disable file server flag */
unsigned short pbByteCnt; // Number of bytes passed in buffer
unsigned char *pbBufPtr; // Pointer to a buffer.
unsigned char pbFlags; // Flags returned by Cuda
unsigned char pbSpare; // reserved
short pbResult; // Result code returned by Cuda
ProcPtr pbCompletion; // Routine to be called on completion
}CudaPB, *CudaPbPtr;
The Cuda Manager functions that you need to use are classified as Pseudo Device functions. Typically, parameters of four bytes or less can be passed to or from the Cuda in the parameter block. An error code may also be returned in the event of an unsuccessful completion of a function.
7
Enable / Disable File Server Mode
This call is used to inform Cuda whether the system should be configured as a standard personal computer or as a file server. When configured as a file server, the system will power itself up any time primary A.C. is available. When configured as a standard personal computer, the system must be powered up either by manual intervention of the user or the power up timer. A value of zero passed to pbParam will configure the system as a standard personal computer while a non zero value will configure the system as a file server.
z
short Enable_FS_Mode()
{
CudaPB thePB;
if(!CheckForCuda() ) return( kNoCudaError);
thePB.pbCmdType = pseudoPkt;
thePB.pbCmd = EnDisFiles;
thePB.pbParam.pByte[0] = 1; //enable or disable
thePB.pbParam.pByte[1] = 0;
thePB.pbParam.pByte[2] = 0;
thePB.pbParam.pByte[3] = 0;
thePB.pbByteCnt = 0
thePB.pbBufPtr = nil;
thePB.pbResult = 0;
thePB.pbCompletion = nil; ¡
Cuda( &thePB );
return thePB.pbResult
}
Note: The mode will revert to a standard personal computer if the Shutdown command is issued.
Working with a UPS
File Server Mode can be used in conjunction with an external Uninterruptible Power Supply (UPS). But it requires that you programatically shut down the Macintosh before the UPS powers off. Since the File Server Mode state is only valid until the next shutdown, you must ÒforceÓ the shutdown into not reverting the Cuda into personal computer mode.
One way to accomplish this is to interact with the shutdown process, as follows:
Near the end of the shutdown process the ShutDownMgr will check the gestaltHard úwareAttr 'hdwr' selector's response for gestaltHasSoftPowerOff (bit 19). If this machine does not have soft power, it puts up the Safe to Shut Off Your Computer alert.
As part of your UPS ManagerÕs setup, you can use the ShutDwnInstall procedure to install a custom shutdown proc that will run before the computer powers down. For example:
Then in your Shutdown proc, you can use the ReplaceGestalt function to intercept the ShutDownMgrÕs Gestalt lookup, so that it returns a response that has the gestaltHasSoftPowerOff bit reset.
Note: Be sure that you read the "Shutdown Manager" chapter of Inside Macintosh: Processes to understand exactly what happens in the shutdown process and the correct way to sh ut down a Macintosh computer.
â
Power Fail Time Clock
The GetPwrFailTime call is used to read the 32 bit integer that represents the last time the system was powered down. The Cuda maintains this in the number of elapsed seconds since January 1, 1904.
Word Get_PwrFail_Time()
{
myCudaPB.pbCmdType = pseudoPkt;
myCudaPB.pbCmd = GetPwrFailTime; // ($27)
myCudaPB.pbParam.pLong = Time;
myCudaPB.pbResult = noErr;
myCudaPB.pbCompletion = NIL;
Cuda( &myCudaPB );
return myCudaPB.pbResult;
}
Note: This function is only available in Cuda Manager 3.0 or greater. The Cuda Manager can be tested by checking the ÔcudaÕ Gestalt selector.
Summary
Although this Technote describes how to configure your Macintosh to automatically restart from a power failure, not all Macin toshes support this feature. This is because there are other ways for Macintosh computers to implement soft power control. For instance, PowerBooks utiltize a completely different system. This is why your code should follow the steps outlined in this Note to check if the Cuda/Egret trap is implemented.
Since accessing the Cuda Manager requires intimate knowledge of low memory globals, it may not work in later Mac OS releases.
Further References
¥ Inside Macintosh: Devices, Chapter 6, Power Manager Reference
¥ Technote 1046: Inside Macintosh: Devices, Power Manager Addenda
Acknowledgments
Special thanks to Ray Montagne, Tom Maremaa, and Mark Baumwell. Z ÿÿ N ° DSET ≠ ÿÿ . H ÿÿÿÿÿÿP´˘ ° √ õ@ Ú ¸ ° ÿÿ 6 ÿÿ * õ@ Ú DSET Ø ÿÿ . H ÿÿÿÿÿÿP’˘ Ú b ° ÿÿ √ ê ° ÿÿ r ° ÿÿ ˘ ú ° ÿÿ
ÿÿÿÿ > ?0 4 7 % ÿÿÿÿ ? @0 4 7 % ÿÿÿÿ @ A0 4 6 & ÿÿÿÿ A C0 4 6 & ÿÿÿÿ B D0 4 8 $ ÿÿÿÿ C E0 4 8 % ÿÿÿÿ % D F‹ ÿÿÿÿ ÿÿ E G0 F F ' ÿÿÿÿ F H0 F F ÿÿÿÿ G I0 F F ÿÿÿÿ H K0 F H ( ÿÿÿÿ I L0 F H ÿÿÿÿ J M0 F H ÿÿÿÿ K O0 F H ! ÿÿÿÿ L P0 F H " ÿÿÿÿ M Q0 F H # ÿÿÿÿ N S0 F G ) $
ÿÿÿÿ O T0 F G ) %
ÿÿÿÿ P U0 F I & ÿÿÿÿ Q W0 F I ' ÿÿÿÿ % R X‹ ÿÿÿÿ ( ÿÿ S Y0 X X * ) ÿÿÿÿ T Z0 X X * ÿÿÿÿ U [0 X X + ÿÿÿÿ V ]0 X Z , ÿÿÿÿ W ^0 X Z - ÿÿÿÿ X _0 X Z . ÿÿÿÿ Y `0 X Z / ÿÿÿÿ Z a0 X Z 0 ÿÿÿÿ [ c0 X Z 1 ÿÿÿÿ \ d0 X Y + 6
ÿÿÿÿ ] e0 X Y + 7
ÿÿÿÿ ^ g0 X [ ! 4
ÿÿÿÿ _ h0 X [ 5
ÿÿÿÿ ` i‹ ÿÿÿÿ ( ÿÿ a k0 i i ) ÿÿ T b l0 i i * ÿÿÿÿ c m0 i i 2 ÿÿÿÿ d n0 i l , ÿÿÿÿ e o0 i l 3 ÿÿÿÿ f p0 i l 8 ÿÿÿÿ g q0 i l 9 ÿÿÿÿ h r0 i l : ÿÿÿÿ i t0 i k , 6
ÿÿÿÿ j u0 i m < ÿÿÿÿ k v‹ ÿÿÿÿ ; ÿÿ l w0 v v - = ÿÿÿÿ m x0 v v > ÿÿÿÿ n y0 v x ÿÿÿÿ o {0 v x ! ÿÿÿÿ p |0 v x " ÿÿÿÿ q }0 v x # ÿÿÿÿ r ~0 v w . A ÿÿÿÿ s 0 v w . B ÿÿÿÿ t •Ø ÿÿÿÿ ÿÿ u ™8 • • ÿÿÿÿ v ≠8 • • ÿÿÿÿ w ∞8 • • ÿÿÿÿ x ≥8 • • ÿÿÿÿ y ∑8 • • ÿÿÿÿ z ∫8 • • ÿÿÿÿ { Ω8 • • ÿÿÿÿ | √8 • • ÿÿÿÿ } ≈8 • • ÿÿÿÿ ~ …8 • • ÿÿÿÿ —8 • • ÿÿÿÿ • ‘8 • • ÿÿÿÿ ™ ⁄Ø ÿÿÿÿ / ! ÿÿ ≠ ∂8 ⁄ ⁄ 5 #ÿÿÿÿ ∞ Œ8 ⁄ ⁄ 7 %ÿÿÿÿ ≥ ‚8 ⁄ ⁄ 8 'ÿÿÿÿ ∑ „8 ⁄ ⁄ ? )ÿÿÿÿ ∫ ‰8 ⁄ ⁄ ? ,ÿÿÿÿ Ω 8 ⁄ ⁄ ? -ÿÿÿÿ √ ˆ8 ⁄ ⁄ ? .ÿÿÿÿ ≈ ˜8 ⁄ ⁄ ? 0ÿÿÿÿ … ˘8 ⁄ ⁄ ? 2ÿÿÿÿ — ˙8 ⁄ ⁄ ? 3ÿÿÿÿ ‘ ˚Ø ÿÿÿÿ 5 ÿÿ Ÿ ˝8 ˚ ˚ 7ÿÿÿÿ ⁄ Ö8 ˚ ˚ 8ÿÿÿÿ ∂ ◊8 ˚ ˚ @ÿÿÿÿ Δ Ø8 ˚ ˚ Aÿÿÿÿ Œ Ù8 ˚ ˚ Bÿÿÿÿ ‚ ¥ ÿÿ 9 ÿÿ ‚ „ œ ÿÿ ¥ 9 ÿÿÿÿ ‰ § ÿÿ ¥ : ÿÿÿÿ Í ÿÿ ÿÿÿÿ ˆ ‹
Í D ÿÿÿÿ ˜ ¶ ÿÿ ÿÿÿÿ ˘ “ ÿÿ <ÿÿÿÿ ˙ ¸ ÿÿ ?ÿÿÿÿ ˚ Ì ÿÿ Hÿÿÿÿ ˝ Ñ ÿÿ Jÿÿÿÿ ˛ Ü ÿÿ Lÿÿÿÿ ˇ â ÿÿ Oÿÿÿÿ ı ë ÿÿ Qÿÿÿÿ ƒ ÿÿ N ÿÿÿÿ 5 ÿÿ O
ÿÿÿÿ ¡ È ÿÿ “ Z =ÿÿÿÿ ¢ É ÿÿ ¸ [ ÿÿÿÿ £ † ÿÿ Ñ ] Dÿÿÿÿ € ì ÿÿ Ü ` Nÿÿÿÿ ¥ ò ÿÿ â b Pÿÿÿÿ œ ö ÿÿ ë e Sÿÿ § ÿÿ ¸
RULRQ‹4 ÿÿ ÿ ÿÿ ÿ ÿÿ ‡ @ ÿÿ [ ÿÿ $ ÿÿ ÿ : B ÿÿ $ ÿÿ $ ÿÿ ÿ @ ÿÿ ÿÿ ÿ z B ÿÿ $ ÿÿ H ÿÿ ÿ ª B < ÿÿ iÿ : B ÿÿ l ÿÿ ÿ b B ÿÿ Δ ÿÿ ´ ÿÿ i≤ r B ÿÿ Ø ÿÿ ü ÿÿ ÿ ÿÿ ÿÿ D ÿÿ h ÿÿ b B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ b B ÿÿ
‘ ÿÿ ifl z B ÿÿ ÷ H ÿÿ ° ÿÿ i÷ b l ÿÿ ÿÿ iÿ ª B < ÿÿ $ ÿÿ iÿ b B ÿÿ H ÿÿ ÷ B ÿÿ l ÿÿ iÿ b f ÿÿ Δ ÿÿ ÿ R ÿÿ ÿ H ÿÿ ´ ÿÿ Ø ÿÿ ü ÿÿ ÿ b l ÿÿ ÿÿ ÷ l ÿÿ D ÿÿ h ÿÿ iˆ b B ÿÿ ÿÿ ÷ $ ÿÿ $ ÿÿ H ÿÿ ÿ B ÿÿ ÷ A ÿÿ aÿ R ÿÿ i  B d b•.@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ ÿ  B d ÿÿ ÿ l ÿÿ i b B b•.@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ l ÿÿ Δ ÿÿ ´ ÿÿ ÿ A ÿÿ ÿ ˚ ÿÿ ÿ ÿÿ ÿ l ÿÿ ÿ b f ÿÿ i b B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ ÿ ÿÿ a ˚ N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆ [ÿÿÿÿ iö … A ÿÿ i z B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ ÿ $ ÿÿ z B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ í bÿô N N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ ÿ bÿô N N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ i j B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ ÿ $ ÿÿ j B N .@Ωµ.Ÿp =
H øŇ2 b|è * ™ ÆS0Å ˙6‰˛Å‡2‰ ÅÿπÆÿÿ i÷ b B ÿÿ é6 b B ] . ≠ . µ . Ä . ‡ .Ÿ . ÿÿ ÿ $ ÿÿ ÿ b B ÿÿ iö z A ÿÿ ÿ z A ÿÿ iÿ z A ÿÿÿÿÿÿ ÿ … A ÿÿ iö z B 2 [ÿÿ HASHΩñ◊ √ZÖ´ HŸHØπ JŸÿ◊Œ P⁄ìÖ€ O˘ùÑ S˙b‹´ Qˇ Ñ Nˇr‹´ L ÿ ÿ
